Compendium Deluxe 1

home *** CD-ROM | disk | FTP | other *** search

/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / disk / misc / qdisk201.lha / QDisk.doc < prev next >

Wrap

Text File | 1994-01-22 | 12.9 KB | 290 lines

---------------------------------------------------------------------- Q D I S K (Query Disk) ~~~~~~~~~~~~~~~~~~~~~~~ Version : 2.01 Written By : Norman Baccari Developement : SAS/C V6.51 Program Icon : JOHN WASZCZAK Interface : GadToolsBox V2.0 by JAN VAN DEN BAARD COPYRIGHT : © 1993-94 Norman J. Baccari Distribution : FREEWARE. "Its Not PD, But Its FREE!" ---------------------------------------------------------------------- DISTRIBUTION ---------------------------------------------------------------------- NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. QDisk is NOT public domain. QDisk may be freely distributed as long as the there are no charges other than for media and / or mailing, the program is not used for commercial gain or included as part of any other software without permission from the author, and the program and the documentaion file remain intact, unalterd and distributed together. QDisk is classed as FREEWARE. All I ask,is that you let me know of any problems or bugs you might encounter, or just let me know what features you think QDisk should have. The following files make up the distribution for QDisk... QDisk Main program. QDisk.doc Standard text documentation. QDisk.guide AmigaGuide format documentation. ---------------------------------------------------------------------- WHAT IS QDISK? ---------------------------------------------------------------------- QDisk provides you with the ability to monitor, from WorkBench, the space usage of all AMIGA DOS disk volumes that are currently mounted. QDisk can also send you a notification when usage exceeds a limit set by you. For the notification, you have the option of a standard requester or a recoverable alert. QDisk requires WB2.04 or higher. ---------------------------------------------------------------------- NEW FOR QDISK V2.00 ---------------------------------------------------------------------- ° QDisk has almost been completely re-written, hence the jump in version from 1.1 to 2.00. ° Complete preference editor replaces all ToolTypes. ° Option to start Iconified. ° Window positions can now be set with a snapshot. ° ListView format now shows both Device & Volume name. ° Uses menu instead of gadgets for less cluttered display. ° Main window can now be sized. ° Notification if %usage is exceeded or free space falls too low. ---------------------------------------------------------------------- QDISK MAIN WINDOW ---------------------------------------------------------------------- To use QDisk simply double click on the program icon or you can place QDisk in you WBStartUp drawer. You will then be presented with the main window on the WorkBench. In it will be a list of volumes currently mounted. The Device/Volume name is displayed with its usage. By simply clicking once on a Device/Volume, a detail window will open showing more information on that particular volume. Iconifying QDisk ~~~~~~~~~~~~~~~~ In the upper right corner there is a small square gadget with the letter "I" in it. Clicking on this will cause QDisk to iconify. To un-iconify, activate the iconified window by clicking once on it and then click the right mouse button. Menus ~~~~~ From the Main window there are 4 menu options... Preferences : Calls up preference editor Iconify : Iconify QDisk About : Author/program info Quit : Quit QDisk Keeping Up To Date ~~~~~~~~~~~~~~~~~~ QDisk reads the systems DOS device/volume lists to update itself. Updates happen whenever a disk is removed or inserted, or the main window is made active. Optionally, you can set updates to take place by activating the timer and setting the timer interval from the preference editor. ---------------------------------------------------------------------- QDISK DETAIL WINDOW ---------------------------------------------------------------------- When you select one of the drives from the main windows listview gadget by clicking on it, you will be presented with a detail window with information on the drive you selected. Across the bottom of the window there is a graphic bar that indicates the space usage based on percent. ---------------------------------------------------------------------- QDISK PREFERENCE EDITOR ---------------------------------------------------------------------- Window Position ~~~~~~~~~~~~~~~ This group of gadgets allows you to set the position of all the windows. You can manually enter values for TopEdge/LeftEdge. These values will be used next time you boot QDisk. Or, if the window is currently open, you can take a snapshot of it. Window height only applies to the Main Window. If you try to snapshot a window thats not open it will be ignored. All windows multi-task so you can have all the windows open at the same time. AutoUpdate ~~~~~~~~~~ This will cause QDisk to be updated using the timer device at the interval that you specify in seconds. The minimum interval is 5 seconds, and maximum interval is 999 seconds. Updates are always performed when a disk is inserted or removed, or the main window is activated. Mark ~~~~ This will cause QDisk to place an asterisk to the left side of any volume that equals or exceeds the percent usage that you specify as the "Mark at %". For example, if you specify a mark at 85% any volume having a percent usage of 85% or more will be marked. Iconify Start ~~~~~~~~~~~~~ If activated QDisk will start up in an iconified state. Setting Up Notification ~~~~~~~~~~~~~~~~~~~~~~~ The greater part of the gadgets in the preference editor are used to set up how you would like to be notified if space usage exceeds your requirements. There are two listviews, VOLUMES and the NOTIFY LIST. The VOLUMES list shows the volumes currently mounted from which you may select. The lists are arranged in two columns, the left showing the device name and the right showing the volume name. Clicking on a volume from the VOLUMES list will make it available to be added to the NOTIFY LIST. When a volume is selected the "ADD" gadget will become active and the current percent usage and free bytes for that volume are displayed in the read only gadgets under the VOLUMES list. If you then click on the "ADD" gadget above the VOLUME list then this volume will be inserted into the NOTIFY LIST. To remove a volume from the NOTIFY LIST, select it by clicking on it and then click on the "REMOVE" gadget. When a volume is added, it is given a set of default parameters and set to be inactive. To change these, select the volume from the NOTIFY LIST. This will activate the gadgets from which you can change these parameters. You can be notified based on percent usage, free bytes left, or both. Notify When Percent Full Exceeds... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This indicates the percent usage at which you would like to be notified. If space usage percent is equal to, or exceeds what you have specified then a notification will be sent. Setting this to 100% is like turning it off. Notify When Free Bytes Less Than... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This indicates the minimum allowable free space before a notification is sent. If the free bytes on a volumes are equal to or less than what you have specified then a notification will be sent. Setting this to 0 is like turning it off. Notification Type ~~~~~~~~~~~~~~~~~ You can be notified in one of two ways. An Intuition Requester or a Recoverable Alert. When a notify is given using an Intuition Requester you will be able to turn off notification or continue. From the Recoverable Alert, the notification state is automatically turned off once you click on a mouse button. From either type, QDisk will tell you the device/volume name that triggered the notify, and the current percent usage and free bytes on the drive. Keep in mind that QDisk will NOT try to halt a process that may be saving or copying data to your drive. Ideally, you should set your notifies to occur at such a time that you can stop the program that is using up drive space. Notify State. ~~~~~~~~~~~~~ This is used to toggle notification between ACTIVE & IN-ACTIVE for the currently selected volume in the NOTIFY LIST. Timed Notifications. ~~~~~~~~~~~~~~~~~~~~ Keep in mind that the more volumes you have for active notification the longer it will take QDisk to complete its update cycle. QDisk first scans the AMIGA DOS list and updates its information. Then it checks each active volume you have in the notification list and compares your usage parameters with current usgae for each active volume. In an extreme situation, if your auto update interval was 5 seconds and there were 20 active volumes to be checked for space usage QDisk would be in a constant update cycle since, by the time it has finished its update cycle QDisk will have received another message from the timer device to perform an update. This means QDisk will be using CPU at a constant rate. The best approach is to allow a time period for each active volume you expect to be notified. The length of time will depend on how fast your system is (I.E. 68000 vs 68040). ---------------------------------------------------------------------- CONTACTING THE AUTHOR ---------------------------------------------------------------------- Internet Address... normb@gpu.utcc.utoronto.ca Otherwise Snail Mail Will Do... Norman Baccari ALGONQUIN SOFTWARE 35 Walmer Road, Suite 201 Toronto, Ontario CANADA M5R 2X3 ---------------------------------------------------------------------- QDISK HISTORY ---------------------------------------------------------------------- ** Jan 1994 v2.01 Program Size : 40564 ** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ** -Rearanged gadgets on prefs editor window and added better label ** to make it more obvious how the percent/free bytes int gadgets work. ** -Forgot to put in Busy Pointer when the "About" option is called ** from the menu. This has been implemented. ** ** Jan 1994 v2.00 Program Size : 39520 ** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ** -Jumped to version 2.00 from 1.1. (Almost a complete rewrite.) ** -All versions from 2.00 will use standard version notation. ** -All tooltypes removed and replaced with a preference editor. ** -Added as preference the ability to start QDisk Iconified. ** -Added snapshot feature to position windows from PrefEd. ** -Set up the ability to be notified when a drive exceeds space usage. ** -Changed Detail window from using IntuiText type display ** to GadTools text gadgets. ** -Main listview format is now a combination of drive/volume Name. ** -The HASH graph removed. ** -Changed the ABOUT credits listview to simple & brief ** system requester. The old way wasn't worth the overhead. ** -Permanently removed the update button. ** -New iconify routine uses a seperate window instead of the zip ** gadget. Activated by gadget in upper right corner above listview. ** -Replaced main window gadgets with menus. ** -Main window is now resizable. ** -Documentation in AmigaGuide Format. ** -Fixed an enforcer hit caused by NOT using LockDosList().(ouch!) ** ** Aug 1993 v1.1a Program Size : 31044 ** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ** -MinorBug in InfoWindow. Text and bar graph would be ** -out of alignment if the screen font was more than ** -8 points. Made 'Y' coordinates relative to Windows ** -TopBorder (window->BorderTop). Thanks Scott! ** ** Jul 1993 v1.1 Program Size : 30860 ** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ** -Removed "OK" gadget from info window. ** -Removed recessed border in info window ** -Moved "gas gage" to bottom of info window. ** -Removed the font drop shadow in info window. ** -List View is only re-rendered on disk insertion ** or disk removal. ** -Auto Update via timer.device toggled on/off ** with AutoUpdate tool type. ** -UPDATE_SECONDS Tool type to set UD interval seconds. ** -New INFO display mode, HASHGRAPH ** -Rounding added to space usage for better accuracy. ** -ZOOM_X & ZOOM_Y tool types added for positioning ** window when zoomed. ** -Update on IDCMP_WINDOWACTIVE ** -SHOW tool type defines main display format for boot-up. ** ** Apr 1993 v1.0 ** ~~~~~~~~~~~~~ ** -Initial public release. ** ** Mar 1993 v0.04 ** ~~~~~~~~~~~~~~ ** -Versions up to 0.04 are unreleased BETA versions. ** ** Jan 1992 v0.00 ** ~~~~~~~~~~~~~~ ** -Original program (Called BOOTMSG) was a wb1.3 probe ** -into device lists based on an article in the april/may ** -1991 issue of AW Tech Journal. It was never released ** -as it was experimental, and stayed dormant until it ** -was given a new life as QDISK.